<template>
  <!-- 使用 v-on="$listeners" 自动绑定父组件所有事件监听器 -->
  <!--
    在 Vue.js 中，v-on=“$listeners” 是一个特殊的语法，用于将父组件传递下来的所有事件监听器绑定到子组件上。
    这里的 $listeners 是一个对象，包含了父组件传递给子组件的所有事件监听器。
  -->
  <!--
    使用 v-on=“$listeners” 的好处是，它允许子组件自动绑定所有从父组件传下来的事件监听器，
    而不需要在子组件中显式地声明和绑定每一个事件。这可以简化代码，并使得组件之间的通信更加灵活。
  -->
  <!--
    vue通信手段有很多种，props/emit、vuex、event bus、provide/inject 等，还有attrs和listeners，主要用于隔代传值
    1、$attrs
    官方解释：包含了父作用域中(父组件)不作为 prop 被识别 (且获取) 的特性绑定 (class和style除外)
    理解：接收除了props声明外的所有绑定属性（class、style除外）
    <template>
      <C_zujian v-bind="$attrs"/> 继承父组件所有属性
      <C_zujian v-bind="$attrs.startOptions" /> 继承父组件的startOptions属性
    </template>
    2、$listeners
    官方解释：包含了父作用域中的 (不含.native修饰器的)v-on事件监听器，主要用于底层组件向高层组件传递信息。
    理解：接收除了带有.native事件修饰符的所有事件监听器
  -->
  <!--
    总结：
    1、这可以理解成穿透，多层组件监听
    2、用于多层级组件之间的通信
    3、高层级向底层级传值 v-bind=‘$attrs’
    4、低层级向高层级传值 v-on=“$listeners”
  -->
  <div v-if="isExternal" :style="styleExternalIcon" class="svg-external-icon svg-icon" v-on="$listeners" />
  <svg v-else :class="svgClass" aria-hidden="true" v-on="$listeners">
    <use :xlink:href="iconName" />
  </svg>
</template>

<script>
// doc: https://panjiachen.github.io/vue-element-admin-site/feature/component/svg-icon.html#usage
import { isExternal } from '@/utils/validate'

export default {
  name: 'SvgIcon',
  props: {
    iconClass: {
      type: String,
      required: true
    },
    className: {
      type: String,
      default: ''
    }
  },
  computed: {
    isExternal() {
      return isExternal(this.iconClass)
    },
    iconName() {
      return `#icon-${this.iconClass}`
    },
    svgClass() {
      if (this.className) {
        return 'svg-icon ' + this.className
      } else {
        return 'svg-icon'
      }
    },
    styleExternalIcon() {
      return {
        mask: `url(${this.iconClass}) no-repeat 50% 50%`,
        '-webkit-mask': `url(${this.iconClass}) no-repeat 50% 50%`
      }
    }
  }
}
</script>

<style scoped>
.svg-icon {
  width: 1em;
  height: 1em;
  vertical-align: -0.15em;
  fill: currentColor;
  overflow: hidden;
}

.svg-external-icon {
  background-color: currentColor;
  mask-size: cover!important;
  display: inline-block;
}
</style>
